v7.0.2

Compare Source

• Enhancement: Replace LocalStack with ElasticMQ for SQS integration tests (mensfeld)

  • ElasticMQ is free, open-source, and requires no auth token (LocalStack 2026.x requires paid account)
  • Uses softwaremill/elasticmq-native image (~30MB vs ~1GB+, starts in milliseconds)
  • Rename setup_localstack to setup_sqs and bin/clean_localstack to bin/clean_sqs

• Fix: Allow custom polling strategy to be configured per-group via add_group (mensfeld)

  • add_group now accepts polling_strategy: keyword argument
  • polling_strategy() reads from the groups hash populated by add_group, with fallback to raw options
  • EnvironmentLoader passes polling_strategy through when parsing YAML group config
  • #​925

v7.0.1

Compare Source

• Enhancement: Add non-retryable exception middleware (Saidbek)

  • #​958

• Fix: ActiveJob keyword arguments support (mensfeld)

  • Jobs with keyword arguments were broken due to improper argument forwarding in SQSSendMessageParametersSupport#initialize
  • Use Ruby's argument forwarding (...) to properly pass all arguments including keyword arguments
  • #​962

• Fix: Replace ArgumentError with custom FifoDelayNotSupportedError for FIFO delay errors

  • Provides more specific error type for programmatic error handling
  • #​957

v7.0.0

Compare Source

See the Upgrading to 7.0 guide for detailed migration instructions.

• Breaking: Add Shoryuken::Errors module with domain-specific error classes

  • Introduces Shoryuken::Errors::BaseError as base class for all Shoryuken errors
  • Shoryuken::Errors::QueueNotFoundError for non-existent or inaccessible SQS queues
  • Shoryuken::Errors::InvalidConfigurationError for configuration validation failures
  • Shoryuken::Errors::InvalidWorkerRegistrationError for worker registration conflicts
  • Shoryuken::Errors::InvalidPollingStrategyError for invalid polling strategy configuration
  • Shoryuken::Errors::InvalidEventError for invalid lifecycle event names
  • Shoryuken::Errors::InvalidDelayError for delays exceeding SQS 15-minute maximum
  • Shoryuken::Errors::InvalidArnError for invalid ARN format
  • Replaces generic Ruby exceptions (ArgumentError, RuntimeError) with specific error types

• Removed: Shoryuken::Shutdown class

  • This class was unused since the Celluloid removal in 2016
  • Originally used to raise on worker threads during hard shutdown
  • Current shutdown flow uses Interrupt and executor-level shutdown instead

• Fix: Raise ArgumentError when using delay with FIFO queues

  • FIFO queues do not support per-message DelaySeconds
  • Previously caused confusing AWS errors with ActiveJob's retry_on (Rails 6.1+ defaults to wait: 3.seconds)
  • Now raises clear ArgumentError with guidance to use wait: 0
  • Fixes #​924

• Enhancement: Use fiber-local storage for logging context

  • Replaces thread-local storage with Fiber[] for proper isolation in async environments
  • Ensures logging context doesn't leak between fibers in the same thread
  • Leverages Ruby 3.2+ fiber-local storage API

• Enhancement: Add yard-lint with comprehensive YARD documentation

  • Adds yard-lint gem for documentation linting
  • Documents all public classes, modules, and methods with YARD tags
  • Ensures 100% documentation coverage

• Enhancement: Add enqueue_all for bulk ActiveJob enqueuing (Rails 7.1+)

  • Implements efficient bulk enqueuing using SQS send_message_batch API
  • Called by ActiveJob.perform_all_later for batching multiple jobs
  • Batches jobs in groups of 10 (SQS limit) per queue
  • Groups jobs by queue name for efficient multi-queue handling

• Enhancement: Add ActiveJob Continuations support (Rails 8.1+)

  • Implements stopping? method in ActiveJob adapters to signal graceful shutdown
  • Enables jobs to checkpoint progress and resume after interruption
  • Handles past timestamps correctly (SQS treats negative delays as immediate delivery)
  • Tracks shutdown state in Launcher via stopping? flag
  • Leverages existing Shoryuken shutdown lifecycle (stop/stop! methods)
  • See Rails PR #​55127 for more details on ActiveJob Continuations

• Enhancement: Add CurrentAttributes persistence support

  • Enables Rails ActiveSupport::CurrentAttributes to flow from enqueue to job execution
  • Automatically serializes current attributes into job payload when enqueuing
  • Restores attributes before job execution and resets them afterward
  • Supports multiple CurrentAttributes classes
  • Based on Sidekiq's approach using ActiveJob::Arguments for serialization
  • Usage: require 'shoryuken/active_job/current_attributes' and
    Shoryuken::ActiveJob::CurrentAttributes.persist('MyApp::Current')

• Breaking: Drop support for Ruby 3.1 (EOL March 2025)

  • Minimum required Ruby version is now 3.2.0
  • Supported Ruby versions: 3.2, 3.3, 3.4
  • Users on Ruby 3.1 should upgrade or remain on Shoryuken 6.x

• Breaking: Remove support for Rails versions older than 7.2

  • Rails 7.0 and 7.1 have reached end-of-life (April 2025) and are no longer supported
  • Supported Rails versions: 7.2, 8.0, and 8.1
  • Users on older Rails versions should upgrade or remain on Shoryuken 6.x

• Enhancement: Replace Concurrent::AtomicFixnum with pure Ruby AtomicCounter

  • Removes external dependency on concurrent-ruby for atomic fixnum operations
  • Introduces Shoryuken::Helpers::AtomicCounter as a thread-safe alternative using Mutex
  • Reduces gem footprint while maintaining full functionality

• Enhancement: Replace Concurrent::AtomicBoolean with pure Ruby AtomicBoolean

  • Removes external dependency on concurrent-ruby for atomic boolean operations
  • Introduces Shoryuken::Helpers::AtomicBoolean extending AtomicCounter
  • Further reduces gem footprint while maintaining full functionality

• Enhancement: Replace Concurrent::Hash with pure Ruby AtomicHash

  • Removes external dependency on concurrent-ruby for hash operations
  • Introduces Shoryuken::Helpers::AtomicHash with mutex-protected writes and concurrent reads
  • Ensures JRuby compatibility while maintaining high performance for read-heavy workloads
  • #​866
  • #​867
  • #​868

• Enhancement: Replace core class extensions with helper utilities

  • Removes all core Ruby class monkey-patching (Hash and String extensions)
  • Introduces Shoryuken::Helpers::HashUtils.deep_symbolize_keys for configuration processing
  • Introduces Shoryuken::Helpers::StringUtils.constantize for dynamic class loading
  • Eliminates unnecessary ActiveSupport dependencies
  • Completely removes lib/shoryuken/core_ext.rb file
  • Maintains all existing functionality while following Ruby best practices
  • Improves code maintainability and reduces global namespace pollution

• Enhancement: Implement Zeitwerk autoloading

  • Replaces manual require statements with Zeitwerk-based autoloading
  • Adds zeitwerk dependency for modern Ruby module loading
  • Splits polling classes into properly named files (BaseStrategy, QueueConfiguration)
  • Reduces startup overhead and improves code organization
  • Maintains backward compatibility while modernizing the codebase

• Enhancement: Increase SendMessageBatch to 1MB to align with AWS

  • #​864

• Enhancement: Replace OpenStruct usage with Struct for inline execution

  • #​860

• Enhancement: Configure server side logging (BenMorganMY)

  • #​844

• Enhancement: Use -1 as thread priority

  • #​825

• Enhancement: Add Support for message_attributes to InlineExecutor

  • #​835

• Enhancement: Introduce trusted publishing

  • #​840

• Enhancement: Add enqueue_after_transaction_commit? for Rails 7.2 compatibility

  • #​777

• Enhancement: Bring Ruby 3.4 into the CI

  • #​805

• Fix integration tests by updating aws-sdk-sqs and replacing moto with LocalStack

  • #​782
  • #​783

• Breaking: Remove support of Ruby versions older than 3.1

  • #​783
  • #​850

• Breaking: Remove support of Rails versions older than 7.0

  • #​783
  • #​850

• Breaking: Require aws-sdk-sqs >= 1.66:

  • #​783